home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / open.z / open
Encoding:
Text File  |  2002-10-03  |  24.8 KB  |  396 lines

  1.  
  2.  
  3.  
  4. ooooppppeeeennnn((((2222))))                                                                ooooppppeeeennnn((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _oooo_pppp_eeee_nnnn - open for reading or writing
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_aaaa_tttt_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ffff_cccc_nnnn_tttt_llll_...._hhhh_>>>>
  15.  
  16.      _iiii_nnnn_tttt _oooo_pppp_eeee_nnnn _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_p_a_t_h_,,,, _iiii_nnnn_tttt _o_f_l_a_g_,,,, _...._...._.... _////_**** _mmmm_oooo_dddd_eeee______tttt _m_o_d_e _****_////_))));
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _p_a_t_h points to a path name naming a file.  _oooo_pppp_eeee_nnnn opens a file descriptor
  20.      for the named file and sets the file status flags according to the value
  21.      of _o_f_l_a_g.  _o_f_l_a_g values are constructed by OR-ing Flags from the
  22.      following list (only one of the first three flags below may be used):
  23.  
  24.      _OOOO______RRRR_DDDD_OOOO_NNNN_LLLL_YYYY
  25.             Open for reading only.
  26.  
  27.      _OOOO______WWWW_RRRR_OOOO_NNNN_LLLL_YYYY
  28.             Open for writing only.
  29.  
  30.      _OOOO______RRRR_DDDD_WWWW_RRRR Open for reading and writing.
  31.  
  32.      _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY or _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK
  33.             These flags may affect subsequent reads and writes [see _rrrr_eeee_aaaa_dddd(2)
  34.             and _wwww_rrrr_iiii_tttt_eeee(2)].  If both _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY and _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK are set,
  35.             _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK will take precedence.
  36.  
  37.             When opening a FIFO with _OOOO______RRRR_DDDD_OOOO_NNNN_LLLL_YYYY or _OOOO______WWWW_RRRR_OOOO_NNNN_LLLL_YYYY set:
  38.  
  39.                     If _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY or _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK is set:  An _oooo_pppp_eeee_nnnn for reading-
  40.                     only will return without delay; an _oooo_pppp_eeee_nnnn for writing-only
  41.                     will return an error if no process currently has the file
  42.                     open for reading.
  43.  
  44.                     If _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY and _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK are clear:  An _oooo_pppp_eeee_nnnn for
  45.                     reading-only will block until a process opens the file for
  46.                     writing; an _oooo_pppp_eeee_nnnn for writing-only will block until a
  47.                     process opens the file for reading.
  48.  
  49.             When opening a file associated with a communication line:
  50.  
  51.                     If _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY or _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK is set:  The open will return
  52.                     without waiting for the device to be ready or available;
  53.                     subsequent behavior of the device is device specific.
  54.  
  55.                     If _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY and _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK are clear:  The open will block
  56.                     until the device is ready or available.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ooooppppeeeennnn((((2222))))                                                                ooooppppeeeennnn((((2222))))
  71.  
  72.  
  73.  
  74.      _OOOO______AAAA_PPPP_PPPP_EEEE_NNNN_DDDD
  75.             If set, the file pointer will be set to the end of the file prior
  76.             to each write.
  77.  
  78.      _OOOO______SSSS_YYYY_NNNN_CCCC When opening a regular file, this flag affects subsequent writes.
  79.             If set, each _wwww_rrrr_iiii_tttt_eeee(2) will wait for both the file data and file
  80.             status to be physically updated.
  81.  
  82.      _OOOO______DDDD_SSSS_YYYY_NNNN_CCCCWhen opening a regular file, this flag affects subsequent writes.
  83.             If set, each _wwww_rrrr_iiii_tttt_eeee(2) will wait for the file data to be physically
  84.             updated.
  85.  
  86.      _OOOO______RRRR_SSSS_YYYY_NNNN_CCCCWhen opening a regular file, this flag affects subsequent reads.
  87.             If set, and either _OOOO______SSSS_YYYY_NNNN_CCCC or _OOOO______DDDD_SSSS_YYYY_NNNN_CCCC is set then each _rrrr_eeee_aaaa_dddd(2) will
  88.             wait for the file to be in the same state as _OOOO______SSSS_YYYY_NNNN_CCCC or _OOOO______DDDD_SSSS_YYYY_NNNN_CCCC
  89.             would require for writes.
  90.  
  91.      _OOOO______NNNN_OOOO_CCCC_TTTT_TTTT_YYYY
  92.             If set and the file is a terminal, the terminal will not be
  93.             allocated as the calling process's controlling terminal.
  94.  
  95.      _OOOO______CCCC_RRRR_EEEE_AAAA_TTTTIf the file exists, this flag has no effect, except as noted under
  96.             _OOOO______EEEE_XXXX_CCCC_LLLL below.  Otherwise, the file is created and the owner ID of
  97.             the file is set to the effective user IDs of the process, the
  98.             group ID of the file is set to the effective group IDs of the
  99.             process or to the group ID of the directory in which the file is
  100.             being created.  This is determined as follows:
  101.                  If the underlying filesystem was mounted with the BSD file
  102.                  creation semantics flag [see _ffff_ssss_tttt_aaaa_bbbb(4)] or the _SSSS______IIII_SSSS_GGGG_IIII_DDDD bit is
  103.                  set [see _cccc_hhhh_mmmm_oooo_dddd(2)] on the parent directory, then the group ID
  104.                  of the new file is set to the group ID of the parent
  105.                  directory, otherwise it is set to the effective group ID of
  106.                  the calling process.
  107.             If the group ID of the new file does not match the effective group
  108.             ID or one of the supplementary groups IDs, the _SSSS______IIII_SSSS_GGGG_IIII_DDDD bit is
  109.             cleared. The access permission bits of the file mode are set to
  110.             the value of _m_o_d_e, modified as follows [see _cccc_rrrr_eeee_aaaa_tttt(2)]:
  111.  
  112.                     All bits set in the file mode creation mask of the process
  113.                     are cleared [see _uuuu_mmmm_aaaa_ssss_kkkk(2)].
  114.  
  115.                     The ``save text image after execution bit'' of the mode is
  116.                     cleared [see _cccc_hhhh_mmmm_oooo_dddd(2)].
  117.  
  118.      _OOOO______TTTT_RRRR_UUUU_NNNN_CCCCIf the file exists and is a regular file, and the file is
  119.             successfully opened _OOOO______RRRR_DDDD_WWWW_RRRR or _OOOO______WWWW_RRRR_OOOO_NNNN_LLLL_YYYY_,,,, its length is truncated to
  120.             0 and the mode and owner are unchanged.  It will have no effect on
  121.             FIFO special files or terminal device files.  It's effect on other
  122.             files types is implementation-dependent.  The result of using
  123.             _OOOO______TTTT_RRRR_UUUU_NNNN_CCCC with _OOOO______RRRR_DDDD_OOOO_NNNN_LLLL_YYYY is undefined.
  124.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134. ooooppppeeeennnn((((2222))))                                                                ooooppppeeeennnn((((2222))))
  135.  
  136.  
  137.  
  138.      _OOOO______EEEE_XXXX_CCCC_LLLL If _OOOO______EEEE_XXXX_CCCC_LLLL and _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT are set, _oooo_pppp_eeee_nnnn will fail if the file exists.
  139.             The check for the existence of the file and the creation of the
  140.             file if it does not exist is atomic with respect to other
  141.             processes executing _oooo_pppp_eeee_nnnn naming the same filename in the same
  142.             directory with _OOOO______EEEE_XXXX_CCCC_LLLL and _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT set.
  143.  
  144.      _OOOO______LLLL_CCCC_FFFF_LLLL_UUUU_SSSS_HHHH
  145.             If set, when all copies of a file descriptor are closed, all
  146.             modified buffers associated with the file will be written back to
  147.             the physical medium.  _OOOO______LLLL_CCCC_FFFF_LLLL_UUUU_SSSS_HHHH is a Silicon Graphics extension.
  148.  
  149.      _OOOO______LLLL_CCCC_IIII_NNNN_VVVV_AAAA_LLLL
  150.             If set, when all copies of a file descriptor are closed, all
  151.             modified buffers associated with the file will be written back to
  152.             the physical medium, then invalidated, immediately freeing the
  153.             buffers for other use.  The process doing the last close must be
  154.             able to aquire write access at the time of last close for the
  155.             cache to be invalidated.  _OOOO______LLLL_CCCC_IIII_NNNN_VVVV_AAAA_LLLL is a Silicon Graphics
  156.             extension.
  157.  
  158.      _OOOO______DDDD_IIII_RRRR_EEEE_CCCC_TTTT
  159.             If set, all reads and writes on the resulting file descriptor will
  160.             be performed directly to or from the user program buffer, provided
  161.             appropriate size and alignment restrictions are met.  Refer to the
  162.             _FFFF______SSSS_EEEE_TTTT_FFFF_LLLL and _FFFF______DDDD_IIII_OOOO_IIII_NNNN_FFFF_OOOO commands in the _ffff_cccc_nnnn_tttt_llll(2) manual entry for
  163.             information about how to determine the alignment constraints.
  164.             _OOOO______DDDD_IIII_RRRR_EEEE_CCCC_TTTT is a Silicon Graphics extension and is only supported on
  165.             local EFS and XFS file systems, and remote BDS file systems.
  166.  
  167.      When opening a STREAMS file, _o_f_l_a_g may be constructed from _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY or
  168.      _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK OR-ed with either _OOOO______RRRR_DDDD_OOOO_NNNN_LLLL_YYYY, _OOOO______WWWW_RRRR_OOOO_NNNN_LLLL_YYYY _,,,, or _OOOO______RRRR_DDDD_WWWW_RRRR.  Other flag
  169.      values are not applicable to STREAMS devices and have no effect on them.
  170.      The values of _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY and _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK affect the operation of STREAMS
  171.      drivers and certain system calls [see _rrrr_eeee_aaaa_dddd(2), _gggg_eeee_tttt_mmmm_ssss_gggg(2), _pppp_uuuu_tttt_mmmm_ssss_gggg(2), and
  172.      _wwww_rrrr_iiii_tttt_eeee(2)].  For drivers, the implementation of _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY and _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK is
  173.      device specific.  Each STREAMS device driver may treat these options
  174.      differently.
  175.  
  176.      When _oooo_pppp_eeee_nnnn is invoked to open a named stream, and the _cccc_oooo_nnnn_nnnn_llll_dddd module [see
  177.      _cccc_oooo_nnnn_nnnn_llll_dddd(7)] has been pushed on the pipe, _oooo_pppp_eeee_nnnn blocks until the server
  178.      process has issued an _IIII______RRRR_EEEE_CCCC_VVVV_FFFF_DDDD _iiii_oooo_cccc_tttt_llll [see _ssss_tttt_rrrr_eeee_aaaa_mmmm_iiii_oooo(7)] to receive the
  179.      file descriptor.
  180.  
  181.      If _p_a_t_h is a symbolic link and _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT and _OOOO______EEEE_XXXX_CCCC_LLLL are set, the link is
  182.      not followed.
  183.  
  184.      The file pointer used to mark the current position within the file is set
  185.      to the beginning of the file.
  186.  
  187.      The new file descriptor is the lowest numbered file descriptor available
  188.      and is set to remain open across _eeee_xxxx_eeee_cccc system calls [see _ffff_cccc_nnnn_tttt_llll(2)].
  189.  
  190.  
  191.  
  192.  
  193.                                                                         PPPPaaaaggggeeee 3333
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200. ooooppppeeeennnn((((2222))))                                                                ooooppppeeeennnn((((2222))))
  201.  
  202.  
  203.  
  204.      Certain flag values can be set following _oooo_pppp_eeee_nnnn as described in _ffff_cccc_nnnn_tttt_llll(2).
  205.  
  206.      If _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT is set and the file did not previously exist, upon successful
  207.      completion _oooo_pppp_eeee_nnnn marks for update the _ssss_tttt______aaaa_tttt_iiii_mmmm_eeee, _ssss_tttt______cccc_tttt_iiii_mmmm_eeee and _ssss_tttt______mmmm_tttt_iiii_mmmm_eeee
  208.      fields of the file and the _ssss_tttt______cccc_tttt_iiii_mmmm_eeee and _ssss_tttt______mmmm_tttt_iiii_mmmm_eeee fields of the parent
  209.      directory.
  210.  
  211.      If _OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is set and the file did previously exist, upon successful
  212.      completion _oooo_pppp_eeee_nnnn marks for update the _ssss_tttt______cccc_tttt_iiii_mmmm_eeee and _ssss_tttt______mmmm_tttt_iiii_mmmm_eeee fields of the
  213.      file.
  214.  
  215.      There is a system enforced limit on the number of open file descriptors
  216.      per process _{{{{_OOOO_PPPP_EEEE_NNNN______MMMM_AAAA_XXXX_}}}}, whose value is returned by the _gggg_eeee_tttt_dddd_tttt_aaaa_bbbb_llll_eeee_ssss_iiii_zzzz_eeee(2)
  217.      function.
  218.  
  219.      The named file is opened unless one or more of the following are true:
  220.  
  221.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS The file does not exist and write permission is denied by the
  222.             parent directory of the file to be created.
  223.  
  224.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT or _OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is specified and write permission is denied.
  225.  
  226.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS A component of the path prefix denies search permission.
  227.  
  228.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS The file is a character or block device file and the file system
  229.             in which it resides has been mounted with the _nnnn_oooo_dddd_eeee_vvvv option [see
  230.             _ffff_ssss_tttt_aaaa_bbbb(4)].
  231.  
  232.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS _o_f_l_a_g permission is denied for an existing file.
  233.  
  234.      _EEEE_AAAA_GGGG_AAAA_IIII_NNNN The file exists, _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT or _OOOO______TTTT_RRRR_UUUU_NNNN_CCCC are specified, mandatory
  235.             file/record locking is set, and there are outstanding record locks
  236.             on the file [see _cccc_hhhh_mmmm_oooo_dddd(2)].
  237.  
  238.      _EEEE_BBBB_UUUU_SSSS_YYYY  _p_a_t_h points to a device special file and the device is in the
  239.             closing state.
  240.  
  241.      _EEEE_DDDD_QQQQ_UUUU_OOOO_TTTT _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT is specified, the file does not exist, and the directory
  242.             in which the entry for the new file is being placed cannot be
  243.             extended either because the user's quota of disk blocks on the
  244.             file system containing the directory has been exhausted or the
  245.             user's quota of inodes on the file system on which the file is
  246.             being created has been exhausted.
  247.  
  248.      _EEEE_EEEE_XXXX_IIII_SSSS_TTTT _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT and _OOOO______EEEE_XXXX_CCCC_LLLL are set, and the named file exists.
  249.  
  250.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT _p_a_t_h points outside the allocated address space of the process.
  251.  
  252.      _EEEE_IIII_NNNN_TTTT_RRRR  A signal was caught during the _oooo_pppp_eeee_nnnn system call.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.                                                                         PPPPaaaaggggeeee 4444
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266. ooooppppeeeennnn((((2222))))                                                                ooooppppeeeennnn((((2222))))
  267.  
  268.  
  269.  
  270.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL An attempt was made to open a file not in an EFS, XFS or BDS file
  271.             system with _OOOO______DDDD_IIII_RRRR_EEEE_CCCC_TTTT set.
  272.  
  273.      _EEEE_IIII_OOOO    A hangup or error occurred during the open of the STREAMS-based
  274.             device.
  275.  
  276.      _EEEE_IIII_SSSS_DDDD_IIII_RRRR The named file is a directory and _o_f_l_a_g is write or read/write.
  277.  
  278.      _EEEE_LLLL_OOOO_OOOO_PPPP  Too many symbolic links were encountered in translating _p_a_t_h.
  279.  
  280.      _EEEE_MMMM_FFFF_IIII_LLLL_EEEE The process has too many open files [see _gggg_eeee_tttt_rrrr_llll_iiii_mmmm_iiii_tttt(2)].
  281.  
  282.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG
  283.             The length of the _p_a_t_h argument exceeds {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX}, or the length
  284.             of a _p_a_t_h component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX} while {______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC} is
  285.             in effect.
  286.  
  287.      _EEEE_NNNN_FFFF_IIII_LLLL_EEEE The system file table is full.
  288.  
  289.      _EEEE_NNNN_OOOO_DDDD_EEEE_VVVV _p_a_t_h points to a device special file and the device is not in the
  290.             activated state.
  291.  
  292.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT is not set and the named file does not exist.
  293.  
  294.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT is set and a component of the path prefix does not exist
  295.             or is the null pathname.
  296.  
  297.      _EEEE_NNNN_OOOO_MMMM_EEEE_MMMM The system is unable to allocate a send descriptor.
  298.  
  299.      _EEEE_NNNN_OOOO_SSSS_PPPP_CCCC _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT and _OOOO______EEEE_XXXX_CCCC_LLLL are set, and the file system is out of inodes
  300.             or the directory in which the entry for the new file is being
  301.             placed cannot be extended because there is no space left on the
  302.             file system containing the directory.
  303.  
  304.      _EEEE_NNNN_OOOO_SSSS_PPPP_CCCC _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT is set and the directory that would contain the file
  305.             cannot be extended.
  306.  
  307.      _EEEE_NNNN_OOOO_SSSS_RRRR  Unable to allocate a stream.
  308.  
  309.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRRA component of the path prefix is not a directory.
  310.  
  311.      _EEEE_NNNN_XXXX_IIII_OOOO  The named file is a character special or block special file, and
  312.             the device associated with this special file does not exist.
  313.  
  314.      _EEEE_NNNN_XXXX_IIII_OOOO  _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY or _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK is set, the named file is a FIFO, _OOOO______WWWW_RRRR_OOOO_NNNN_LLLL_YYYY
  315.             is set, and no process has the file open for reading.
  316.  
  317.      _EEEE_NNNN_XXXX_IIII_OOOO  A STREAMS module or driver open routine failed.
  318.  
  319.      _EEEE_OOOO_PPPP_NNNN_OOOO_TTTT_SSSS_UUUU_PPPP_PPPP
  320.             An attempt was made to open a socket (not currently supported).
  321.  
  322.  
  323.  
  324.  
  325.                                                                         PPPPaaaaggggeeee 5555
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332. ooooppppeeeennnn((((2222))))                                                                ooooppppeeeennnn((((2222))))
  333.  
  334.  
  335.  
  336.      _EEEE_PPPP_EEEE_RRRR_MMMM  _p_a_t_h points to a device special file, the device is in the setup
  337.             state, and the calling process does not have the _PPPP______DDDD_EEEE_VVVV privilege.
  338.  
  339.      _EEEE_TTTT_IIII_MMMM_EEEE_DDDD_OOOO_UUUU_TTTT
  340.             The object of the open is located on a remote system which is not
  341.             available [see _iiii_nnnn_tttt_rrrr_oooo(2)].
  342.  
  343.      _EEEE_RRRR_OOOO_FFFF_SSSS  The named file resides on a read-only file system and either
  344.             _OOOO______WWWW_RRRR_OOOO_NNNN_LLLL_YYYY, _OOOO______RRRR_DDDD_WWWW_RRRR, _OOOO______CCCC_RRRR_EEEE_AAAA_TTTT, or _OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is set in _o_f_l_a_g (if the file
  345.             does not exist).
  346.  
  347. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  348.      _cccc_hhhh_mmmm_oooo_dddd(2), _cccc_llll_oooo_ssss_eeee(2), _cccc_rrrr_eeee_aaaa_tttt(2), _dddd_uuuu_pppp(2), _eeee_xxxx_eeee_cccc(2), _ffff_cccc_nnnn_tttt_llll(2),
  349.      _gggg_eeee_tttt_dddd_tttt_aaaa_bbbb_llll_eeee_ssss_iiii_zzzz_eeee(2), _gggg_eeee_tttt_mmmm_ssss_gggg(2), _gggg_eeee_tttt_rrrr_llll_iiii_mmmm_iiii_tttt(2), _iiii_nnnn_tttt_rrrr_oooo(2), _llll_ssss_eeee_eeee_kkkk(2), _pppp_uuuu_tttt_mmmm_ssss_gggg(2),
  350.      _rrrr_eeee_aaaa_dddd(2), _ssss_tttt_aaaa_tttt(2), _ssss_tttt_aaaa_tttt(5), _uuuu_mmmm_aaaa_ssss_kkkk(2), _wwww_rrrr_iiii_tttt_eeee(2)
  351.  
  352. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  353.      Upon successful completion, the file descriptor is returned.  Otherwise,
  354.      a value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.                                                                         PPPPaaaaggggeeee 6666
  392.  
  393.  
  394.  
  395.